/* Copyright (c) 2015 Nordic Semiconductor. All Rights Reserved.
 *
 * The information contained herein is property of Nordic Semiconductor ASA.
 * Terms and conditions of usage are described in detail in NORDIC
 * SEMICONDUCTOR STANDARD SOFTWARE LICENSE AGREEMENT.
 *
 * Licensees are granted free, non-transferable use of the information. NO
 * WARRANTY of ANY KIND is provided. This heading must NOT be removed from
 * the file.
 *
 */

/** @file
 *
 * @defgroup ant_sdk_profiles_bsc Bicycle Speed and Cadence profile
 * @{
 * @ingroup ant_sdk_profiles
 * @brief This module implements the Bicycle Speed and Cadence profile.
 *
 */

#ifndef ANT_BSC_H__
#define ANT_BSC_H__

#include <stdint.h>
#include <stdbool.h>
#include "sdk_errors.h"
#include "ant_parameters.h"
#include "ant_stack_handler_types.h"
#include "ant_channel_config.h"
#include "ant_bsc_pages.h"

#define BSC_ANTPLUS_RF_FREQ 0x39u ///< Frequency, decimal 57 (2457 MHz).

#define BSC_SPEED_DEVICE_TYPE 0x7B    ///< Device type reserved for ANT+ bike speed sensor.
#define BSC_CADENCE_DEVICE_TYPE 0x7A  ///< Device type reserved for ANT+ bike cadence sensor.
#define BSC_COMBINED_DEVICE_TYPE 0x79 ///< Device type reserved for ANT+ bike combined speed and cadence sensor.

#define BSC_MSG_PERIOD_4Hz 1u           ///< Message period, 4 Hz (in basic period counts, where basic period time = 0.25 s).
#define BSC_MSG_PERIOD_2Hz 2u           ///< Message period, 2 Hz (in basic period counts).
#define BSC_MSG_PERIOD_1Hz 4u           ///< Message period, 1 Hz (in basic period counts).
#define BSC_MSG_PERIOD_SPEED 0x1FB6u    ///< Message period in ticks, decimal 8118 (4.04 Hz).
#define BSC_MSG_PERIOD_CADENCE 0x1FA6u  ///< Message period in ticks, decimal 8102 (4.04 Hz).
#define BSC_MSG_PERIOD_COMBINED 0x1F96u ///< Message period in ticks, decimal 8086 (4.05 Hz).

#define BSC_EXT_ASSIGN 0x00                              ///< ANT ext assign (see Ext. Assign Channel Parameters in ant_parameters.h: @ref ant_parameters).
#define BSC_DISP_CHANNEL_TYPE CHANNEL_TYPE_SLAVE_RX_ONLY ///< Display BSC channel type.
#define BSC_SENS_CHANNEL_TYPE CHANNEL_TYPE_MASTER        ///< Sensor BSC channel type.

/**@brief Select the basic ANT channel period (in ticks) for the BSC profile depending on the device type.
 *
 * @param[in]  DEVICE_TYPE          Type of device. Supported types: @ref BSC_SPEED_DEVICE_TYPE, @ref BSC_CADENCE_DEVICE_TYPE,
 *                                  @ref BSC_COMBINED_DEVICE_TYPE.
 */
#define BSC_DEVICE_TICKS(DEVICE_TYPE)                                                                                                                                                                  \
    ((DEVICE_TYPE) == (BSC_SPEED_DEVICE_TYPE)                                                                                                                                                          \
         ? (BSC_MSG_PERIOD_SPEED)                                                                                                                                                                      \
         : ((DEVICE_TYPE) == (BSC_CADENCE_DEVICE_TYPE) ? (BSC_MSG_PERIOD_CADENCE) : ((DEVICE_TYPE) == (BSC_COMBINED_DEVICE_TYPE) ? (BSC_MSG_PERIOD_COMBINED) : 0u)))

/**@brief Calculate the channel period (in ticks) depending on the device type and the chosen message frequency.
 *
 * @param[in]  DEVICE_TYPE          Type of device. Supported types: @ref BSC_SPEED_DEVICE_TYPE, @ref BSC_CADENCE_DEVICE_TYPE,
 *                                  @ref BSC_COMBINED_DEVICE_TYPE.
 * @param[in]  BSC_MSG_PERIOD       Channel data period. The BSC profile supports only the following periods:
 *                                  @ref BSC_MSG_PERIOD_4Hz, @ref BSC_MSG_PERIOD_2Hz, @ref BSC_MSG_PERIOD_1Hz.
 */
#define BSC_PERIOD_TICKS(DEVICE_TYPE, BSC_MSG_PERIOD) ((BSC_DEVICE_TICKS(DEVICE_TYPE)) * (BSC_MSG_PERIOD))

/**@brief Initialize an ANT channel configuration structure for the BSC profile (Display).
 *
 * @param[in]  NAME                 Name of related instance.
 * @param[in]  CHANNEL_NUMBER       Number of the channel assigned to the profile instance.
 * @param[in]  TRANSMISSION_TYPE    Type of transmission assigned to the profile instance.
 * @param[in]  DEVICE_TYPE          Type of device. Supported types: @ref BSC_SPEED_DEVICE_TYPE, @ref BSC_CADENCE_DEVICE_TYPE,
 *                                  @ref BSC_COMBINED_DEVICE_TYPE.
 * @param[in]  DEVICE_NUMBER        Number of the device assigned to the profile instance.
 * @param[in]  NETWORK_NUMBER       Number of the network assigned to the profile instance.
 * @param[in]  BSC_MSG_PERIOD       Channel data frequency in Hz. The BSC profile supports only the following frequencies:
 *                                  @ref BSC_MSG_PERIOD_4Hz, @ref BSC_MSG_PERIOD_2Hz, @ref BSC_MSG_PERIOD_1Hz.
 */
#define BSC_DISP_CHANNEL_CONFIG_DEF(NAME, CHANNEL_NUMBER, TRANSMISSION_TYPE, DEVICE_TYPE, DEVICE_NUMBER, NETWORK_NUMBER, BSC_MSG_PERIOD)                                                               \
    static const ant_channel_config_t NAME##_channel_bsc_disp_config = {                                                                                                                               \
        .channel_number = (CHANNEL_NUMBER),                                                                                                                                                            \
        .channel_type = BSC_DISP_CHANNEL_TYPE,                                                                                                                                                         \
        .ext_assign = BSC_EXT_ASSIGN,                                                                                                                                                                  \
        .rf_freq = BSC_ANTPLUS_RF_FREQ,                                                                                                                                                                \
        .transmission_type = (TRANSMISSION_TYPE),                                                                                                                                                      \
        .device_type = (DEVICE_TYPE),                                                                                                                                                                  \
        .device_number = (DEVICE_NUMBER),                                                                                                                                                              \
        .channel_period = BSC_PERIOD_TICKS(DEVICE_TYPE, BSC_MSG_PERIOD),                                                                                                                               \
        .network_number = (NETWORK_NUMBER),                                                                                                                                                            \
    }
#define BSC_DISP_CHANNEL_CONFIG(NAME) &NAME##_channel_bsc_disp_config

/**@brief Initialize an ANT channel configuration structure for the BSC profile (Transmitter).
 *
 * @param[in]  NAME                 Name of related instance.
 * @param[in]  CHANNEL_NUMBER       Number of the channel assigned to the profile instance.
 * @param[in]  TRANSMISSION_TYPE    Type of transmission assigned to the profile instance.
 * @param[in]  DEVICE_TYPE          Type of device. Supported types: @ref BSC_SPEED_DEVICE_TYPE, @ref BSC_CADENCE_DEVICE_TYPE,
 *                                  @ref BSC_COMBINED_DEVICE_TYPE.
 * @param[in]  DEVICE_NUMBER        Number of the device assigned to the profile instance.
 * @param[in]  NETWORK_NUMBER       Number of the network assigned to the profile instance.
 */
#define BSC_SENS_CHANNEL_CONFIG_DEF(NAME, CHANNEL_NUMBER, TRANSMISSION_TYPE, DEVICE_TYPE, DEVICE_NUMBER, NETWORK_NUMBER)                                                                               \
    static const ant_channel_config_t NAME##_channel_bsc_sens_config = {                                                                                                                               \
        .channel_number = (CHANNEL_NUMBER),                                                                                                                                                            \
        .channel_type = BSC_SENS_CHANNEL_TYPE,                                                                                                                                                         \
        .ext_assign = BSC_EXT_ASSIGN,                                                                                                                                                                  \
        .rf_freq = BSC_ANTPLUS_RF_FREQ,                                                                                                                                                                \
        .transmission_type = (TRANSMISSION_TYPE),                                                                                                                                                      \
        .device_type = (DEVICE_TYPE),                                                                                                                                                                  \
        .device_number = (DEVICE_NUMBER),                                                                                                                                                              \
        .channel_period = BSC_PERIOD_TICKS(DEVICE_TYPE, BSC_MSG_PERIOD_4Hz),                                                                                                                           \
        .network_number = (NETWORK_NUMBER),                                                                                                                                                            \
    }
#define BSC_SENS_CHANNEL_CONFIG(NAME) &NAME##_channel_bsc_sens_config

/**@brief Initialize an ANT profile configuration structure for the BSC profile (Display).
 *
 * @param[in]  NAME                 Name of related instance.
 * @param[in]  EVT_HANDLER          Event handler to be called for handling events in the BSC profile.
 */
#define BSC_DISP_PROFILE_CONFIG_DEF(NAME, EVT_HANDLER)                                                                                                                                                 \
    static ant_bsc_disp_cb_t NAME##_bsc_disp_cb;                                                                                                                                                       \
    static const ant_bsc_disp_config_t NAME##_profile_bsc_disp_config = {                                                                                                                              \
        .p_cb = &NAME##_bsc_disp_cb,                                                                                                                                                                   \
        .evt_handler = (EVT_HANDLER),                                                                                                                                                                  \
    }
#define BSC_DISP_PROFILE_CONFIG(NAME) &NAME##_profile_bsc_disp_config

/**@brief Initialize an ANT profile configuration structure for the BSC profile (Sensor).
 *
 * @param[in]  NAME                 Name of related instance.
 * @param[in]  PAGE_1_PRESENT       Determines whether page 1 is included.
 * @param[in]  PAGE_4_PRESENT       Determines whether page 4 is included.
 * @param[in]  MAIN_PAGE_NUMBER     Determines the main data page (@ref ANT_BSC_PAGE_0 or @ref ANT_BSC_PAGE_5 or @ref ANT_BSC_COMB_PAGE_0).
 * @param[in]  EVT_HANDLER          Event handler to be called for handling events in the BSC profile.
 */
#define BSC_SENS_PROFILE_CONFIG_DEF(NAME, PAGE_1_PRESENT, PAGE_4_PRESENT, MAIN_PAGE_NUMBER, EVT_HANDLER)                                                                                               \
    static ant_bsc_sens_cb_t NAME##_bsc_sens_cb;                                                                                                                                                       \
    static const ant_bsc_sens_config_t NAME##_profile_bsc_sens_config = {                                                                                                                              \
        .page_1_present = (PAGE_1_PRESENT),                                                                                                                                                            \
        .page_4_present = (PAGE_4_PRESENT),                                                                                                                                                            \
        .main_page_number = (MAIN_PAGE_NUMBER),                                                                                                                                                        \
        .p_cb = &NAME##_bsc_sens_cb,                                                                                                                                                                   \
        .evt_handler = (EVT_HANDLER),                                                                                                                                                                  \
    }
#define BSC_SENS_PROFILE_CONFIG(NAME) &NAME##_profile_bsc_sens_config

/**@brief BSC page number type. */
typedef enum
{
    ANT_BSC_PAGE_0,     ///< Main data page number 0.
    ANT_BSC_PAGE_1,     ///< Background data page number 1. This page is optional.
    ANT_BSC_PAGE_2,     ///< Background data page number 2.
    ANT_BSC_PAGE_3,     ///< Background data page number 3.
    ANT_BSC_PAGE_4,     ///< Background data page number 4. This page is optional.
    ANT_BSC_PAGE_5,     ///< Main data page number 5. This page is optional.
    ANT_BSC_COMB_PAGE_0 ///< Main data page number 0 for combined speed and cadence sensor.
} ant_bsc_page_t;

/**@brief BSC profile event type. */
typedef enum
{
    ANT_BSC_PAGE_0_UPDATED = ANT_BSC_PAGE_0,           ///< Data page 0 has been updated (Display) or sent (Sensor).
    ANT_BSC_PAGE_1_UPDATED = ANT_BSC_PAGE_1,           ///< Data page 0 and page 1 have been updated (Display) or sent (Sensor).
    ANT_BSC_PAGE_2_UPDATED = ANT_BSC_PAGE_2,           ///< Data page 0 and page 2 have been updated (Display) or sent (Sensor).
    ANT_BSC_PAGE_3_UPDATED = ANT_BSC_PAGE_3,           ///< Data page 0 and page 3 have been updated (Display) or sent (Sensor).
    ANT_BSC_PAGE_4_UPDATED = ANT_BSC_PAGE_4,           ///< Data page 0 and page 4 have been updated (Display) or sent (Sensor).
    ANT_BSC_PAGE_5_UPDATED = ANT_BSC_PAGE_5,           ///< Data page 0 and page 5 have been updated (Display) or sent (Sensor).
    ANT_BSC_COMB_PAGE_0_UPDATED = ANT_BSC_COMB_PAGE_0, ///< Combined Speed and cadence data page has been updated (Display) or sent (Sensor).
} ant_bsc_evt_t;

// Forward declaration of the ant_bsc_profile_t type.
typedef struct ant_bsc_profile_s ant_bsc_profile_t;

/**@brief BSC event handler type. */
typedef void (*ant_bsc_evt_handler_t)(ant_bsc_profile_t *, ant_bsc_evt_t);

#include "ant_bsc_local.h"

/**@brief BSC Display configuration structure. */
typedef struct
{
    ant_bsc_disp_cb_t *p_cb;           ///< Pointer to the data buffer for internal use.
    ant_bsc_evt_handler_t evt_handler; ///< Event handler to be called for handling events in the BSC profile.
} ant_bsc_disp_config_t;

/**@brief BSC Sensor configuration structure. */
typedef struct
{
    bool page_1_present;               ///< Determines whether page 1 is included.
    bool page_4_present;               ///< Determines whether page 4 is included.
    ant_bsc_page_t main_page_number;   ///< Determines the main data page (@ref ANT_BSC_PAGE_0 or @ref ANT_BSC_PAGE_5 or @ref ANT_BSC_COMB_PAGE_0).
    ant_bsc_sens_cb_t *p_cb;           ///< Pointer to the data buffer for internal use.
    ant_bsc_evt_handler_t evt_handler; ///< Event handler to be called for handling events in the BSC profile.
} ant_bsc_sens_config_t;

/**@brief BSC profile structure. */
struct ant_bsc_profile_s
{
    uint8_t channel_number; ///< Channel number assigned to the profile.
    union {
        ant_bsc_disp_cb_t *p_disp_cb;
        ant_bsc_sens_cb_t *p_sens_cb;
    } _cb;                                     ///< Pointer to internal control block.
    ant_bsc_evt_handler_t evt_handler;         ///< Event handler to be called for handling events in the BSC profile.
    ant_bsc_page0_data_t page_0;               ///< Page 0.
    ant_bsc_page1_data_t page_1;               ///< Page 1.
    ant_bsc_page2_data_t page_2;               ///< Page 2.
    ant_bsc_page3_data_t page_3;               ///< Page 3.
    ant_bsc_page4_data_t page_4;               ///< Page 4.
    ant_bsc_page5_data_t page_5;               ///< Page 5.
    ant_bsc_combined_page0_data_t page_comb_0; ///< Page 0 for combined speed and cadence sensor.
};

/** @name Defines for accessing ant_bsc_profile_t member variables
@{ */
#define BSC_PROFILE_event_time page_0.event_time
#define BSC_PROFILE_rev_count page_0.rev_count
#define BSC_PROFILE_operating_time page_1.operating_time
#define BSC_PROFILE_manuf_id page_2.manuf_id
#define BSC_PROFILE_serial_num page_2.serial_num
#define BSC_PROFILE_hw_version page_3.hw_version
#define BSC_PROFILE_sw_version page_3.sw_version
#define BSC_PROFILE_model_num page_3.model_num
#define BSC_PROFILE_fract_bat_volt page_4.fract_bat_volt
#define BSC_PROFILE_coarse_bat_volt page_4.coarse_bat_volt
#define BSC_PROFILE_bat_status page_4.bat_status
#define BSC_PROFILE_stop_indicator page_5.stop_indicator
#define BSC_PROFILE_cadence_event_time page_comb_0.cadence_event_time
#define BSC_PROFILE_cadence_rev_count page_comb_0.cadence_rev_count
#define BSC_PROFILE_speed_event_time page_comb_0.speed_event_time
#define BSC_PROFILE_speed_rev_count page_comb_0.speed_rev_count
/** @} */

/**@brief Function for initializing the ANT BSC profile instance.
 *
 * @param[in]  p_profile        Pointer to the profile instance.
 * @param[in]  p_channel_config Pointer to the ANT channel configuration structure.
 * @param[in]  p_disp_config    Pointer to the BSC display configuration structure.
 *
 * @retval     NRF_SUCCESS      If initialization was successful. Otherwise, an error code is returned.
 */
ret_code_t ant_bsc_disp_init(ant_bsc_profile_t *p_profile, ant_channel_config_t const *p_channel_config, ant_bsc_disp_config_t const *p_disp_config);

/**@brief Function for initializing the ANT BSC profile instance.
 *
 * @param[in]  p_profile        Pointer to the profile instance.
 * @param[in]  p_channel_config Pointer to the ANT channel configuration structure.
 * @param[in]  p_sens_config    Pointer to the BSC sensor configuration structure.
 *
 * @retval     NRF_SUCCESS      If initialization was successful. Otherwise, an error code is returned.
 */
ret_code_t ant_bsc_sens_init(ant_bsc_profile_t *p_profile, ant_channel_config_t const *p_channel_config, ant_bsc_sens_config_t const *p_sens_config);

/**@brief Function for opening the profile instance channel for the ANT BSC Display.
 *
 * Before calling this function, pages should be configured.
 *
 * @param[in]  p_profile        Pointer to the profile instance.
 *
 * @retval     NRF_SUCCESS      If the channel was successfully opened. Otherwise, an error code is returned.
 */
ret_code_t ant_bsc_disp_open(ant_bsc_profile_t *p_profile);

/**@brief Function for opening the profile instance channel for the ANT BSC Sensor.
 *
 * Before calling this function, pages should be configured.
 *
 * @param[in]  p_profile        Pointer to the profile instance.
 *
 * @retval     NRF_SUCCESS      If the channel was successfully opened. Otherwise, an error code is returned.
 */
ret_code_t ant_bsc_sens_open(ant_bsc_profile_t *p_profile);

/**@brief Function for handling the Sensor ANT events.
 *
 * @details This function handles all events from the ANT stack that are of interest to the Bicycle Speed and Cadence Sensor profile.
 *
 * @param[in]   p_profile       Pointer to the profile instance.
 * @param[in]   p_ant_event     Event received from the ANT stack.
 */
void ant_bsc_sens_evt_handler(ant_bsc_profile_t *p_profile, ant_evt_t *p_ant_event);

/**@brief Function for handling the Display ANT events.
 *
 * @details This function handles all events from the ANT stack that are of interest to the Bicycle Speed and Cadence Display profile.
 *
 * @param[in]   p_profile       Pointer to the profile instance.
 * @param[in]   p_ant_event     Event received from the ANT stack.
 */
void ant_bsc_disp_evt_handler(ant_bsc_profile_t *p_profile, ant_evt_t *p_ant_event);

#endif // ANT_BSC_H__
/** @} */
